Replace a Faulty Device

You can use the XCO command line to replace a faulty device with a new device and maintain the configuration of the old device.

1. Obtain the configuration backup of the old device.
   For more information, see Configure Backup and Replay.
   

   # efa inventory config-backup execute --ip <ip-addr>

   This step generates a configuration backup ID that you use in step 5.
2. Replace the faulty device with the new device.
3. Ensure that the ports of the new device are administratively up and online.
   The ports on the new device must have the same connections as the old device. For example, if the old device Ethernet port1 and port2 went to port3 and port4 of another device, the new replacement device must have these exact same Ethernet port connections.
4. Configure the new device with the same management IP address and credentials as the old device.
5. Start the RMA process.
   

   # efa inventory rma execute --ip <ip-addr> --config-backup-id <id>

   

   Note

   As a best practice, run the command with the --config-backup-id <id> option so that the configuration is properly restored. If you run the command without the backup ID, you must manually update the configuration on the new device.
6. View the RMA history and detail.
   

   # efa inventory rma history -–ip <ip-addr>
   # efa inventory rma detail –uuid <uuid>

7. View the drift reconcile history and detail.
   

   # efa inventory drift-reconcile history -–device-ip <ip-addr>
   # efa inventory drift-reconcile detail –-uuid <uuid>

8. Install the HTTPS or OAuth2 certificate on the new device.
   

   # efa certificates device install --ips <device-ip-addr> --certType [https|token]

9. Optional: Delete the RMA record.
   

   # efa inventory rma delete -–ip <ip-addr>

10. Optional: Manually start the drift reconcile process if the RMA process fails during the drift reconcile stage.
    

    # efa inventory drift-reconcile execute --ip <ip-addr> –-reconcile